EloRating (version 0.46.11)

stab_elo: stability index S

Description

calculates the S index as metric for the overall stability of a hierarchy during a specified time period

Usage

stab_elo(
  eloobject,
  from = min(eloobject$stability$date),
  to = max(eloobject$stability$date),
  weight = TRUE
)

Value

returns the S index

Arguments

eloobject

an object of class "elo", usually the result of a call to elo.seq

from

character, from which date onwards should S be calculated. By default the first date in the sequence is used

to

character, until which date should S be calculated. By default the last date in the sequence is used

weight

logical, should single rank changes be weighted by the Elo rating of the highest-rated individual involved in a rank change? Default is TRUE

Author

Christof Neumann

Details

S ranges between 0 and 1, where 0 indicates an unstable hierarchy, in which the ordering reverses every other day, and 1, in which the ordering is stable and no rank changes occur.

In contrast to the originally proposed S, this version is now standardized between 0 and 1, and additionally, the interpretation is reversed, i.e. 1 refers to stable situations, whereas values closer to 0 indicate more instable hierarchies

References

neumann2011EloRating

mcdonald2013aEloRating

Examples

data(adv)
SEQ <- elo.seq(winner=adv$winner, loser=adv$loser, Date=adv$Date)
stab_elo(SEQ)
stab_elo(SEQ, weight=FALSE)
stab_elo(SEQ, from="2010-01-20", to="2010-01-30")
stab_elo(SEQ, from="2010-01-20", to="2010-01-30", weight=FALSE)