steepness {EloRating}

hierarchy steepness based on David's scores

Description

hierarchy steepness based on David's scores

Usage

steepness(mat, nrand = 0, Dij = TRUE, returnfig = FALSE)

Arguments

mat

square dominance matrix

nrand

numeric, the number of runs for the randomization test

Dij

logical, by default TRUE i.e. corrected for number of interactions in a dyad, otherwise simple proportion of wins/losses

returnfig

logical, should a figure be produced that shows the distribution of expected steepness

Value

a named vector, with the observed steepness, the expected steepness, p-value and the number of randomizations used

Author(s)

Christof Neumann

References

de Vries H, Stevens JMG, Vervaecke H (2006). “Measuring and testing the steepness of dominance hierarchies.” Animal Behaviour, 71, 585-592. doi:10.1016/j.anbehav.2005.05.015.

Examples

data(bonobos)
steepness(bonobos) # no randomization test

# with randomization test
steepness(bonobos, nrand = 100)