stab_elo: stability index _S_

View source: R/stab_elo.R

stab_eloR Documentation

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
)

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

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

Value

returns the S index

Author(s)

Christof Neumann

References

\insertRef

neumann2011EloRating

\insertRef

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)

gobbios/EloRating documentation built on July 19, 2024, 4:05 a.m.