indval: IndVal scores based on relative abundance across, and...

Description Usage Arguments Details Value Author(s) References See Also


Calculates indicator value scores using the original method of Dufrene and Legendre (1997) for all taxa in a site-by-taxon matrix split into two groups along an environmental gradient. A modified version (indvals) calculates indicator value scores using a modification of Dufrene and Legendre (1997), whereby relative abundance is computed as total relative abundance across groups rather than as mean relative abundance.


indval(grp, spp, allscores = FALSE)

indvals(grp, spp, allscores = FALSE)



A binary vector (0,1) indicating group membership for partitioning of rows in 'spp' according to a ranks of an environmental variable.


A site-by-taxon matrix of taxa counts at each sampling location.


A logical indicating whether the list of scores returned by the function should be truncated. The default is to return just the largest IndVal (of two, one for each side of the partition) and on which side of the partition the score occurs. If allscores is TRUE, IndVals on both sides of the partition, as well as their relative abundances are also returned.


The modified version of the original IndVal method was developed to address potential for bias in change point identification for highly skewed samples. This and the function 'indvalps' are run when the argument 'ivTot' in the original TITAN function call is set to TRUE. The function 'indval' is expected to be used more frequently, and 'indvals' is provided largely for comparative purposes.


A 2-column matrix with the same nrow as the matrix 'spp'. The first column consists of a 1 (left) or 2 (right) for each taxon indicating on which group produced the largest IndVal score, and the second column contains the actual IndVal score.


M. Baker and R. King


Dufrene, M. and P. Legendre. 1997. Species assemblages and indicator species: the need for a flexible asymmetrical approach. Ecological Monographs 67:345-366.

See Also

indvalp, indvalps, getivz, b.getivz

Search within the TITAN2 package
Search all R packages, documentation and source code

Questions? Problems? Suggestions? or email at

Please suggest features or report bugs with the GitHub issue tracker.

All documentation is copyright its authors; we didn't write any of that.