TITAN2 (version 2.4)

sumz.tab: Summarizes the results of the community-level sum(z) analysis

Description

This function populates the sumz.cp table using the resuls from function 'ivzsums' and, if 'boot'=TRUE, calls 'ivsums.f' to compute ivz sums filtered by pure and reliable taxa.

Usage

sumz.tab(
  ivzScores,
  ivz,
  srtEnv,
  sppmax,
  maxSumz = maxSumz,
  maxFsumz = maxFsumz,
  minSplt = minSplt,
  boot = boot
)

Arguments

ivzScores

The product of the 'getivz' function. A data matrix comprised of four submatrices including group membership, z scores, IndVals, and p values.

ivz

The product of the 'ivzsums' function. A data matrix comprised of two parallel vectors of sum(z-) and sum(z+) scores.

srtEnv

A sorted version of the environmental gradient.

sppmax

The taxon-specific summary output table from TITAN, passed to 'ivzsums.f'.

maxSumz

A vector of sum(z) maxima across bootstrap replicates.

maxFsumz

A vector of sum(z) maxima filtered by pure and reliable taxa across bootstrap replicates.

minSplt

The minimum split size used to partition the environmental gradient. The default is to use the argument specified by the original TITAN function call.

boot

A logical indicating whether the bootstrap procedure should be implemented. The default is to use the argument specified by the original TITAN function call.

Value

A list with two objects:

  • sumz.cpA second summary output table from TITAN to accompany 'sppmax'.

  • ivz.fThe product of the 'ivzsums.f' function. A data matrix comprised of two parallel vectors of filtered sum(z-) and sum(z+) scores.

Details

The function locates the env values of sum(z) maxima, then if 'boot'=TRUE, locates the the env value of the filtered sum(z) and provides bootstrap quantiles of both filtered and unfiltered distributions.

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.

King, RS and ME Baker 2010. Considerations for identifying and interpreting ecological community thresholds. Journal of the North American Benthological Association 29(3):998-1008.

See Also

ivzsums(), ivzsums.f(), getivz(), titan()