Description Usage Arguments Value References Examples
Use Elo-rating method to infer a dominance hierarchy over multiple study periods. New contestants are added according to the convention specified by the user. Full description of the addition of new individuals is described in Strauss & Holekamp (in revision). To run the original Elo-rating procedure, use convention flag 'none'.
1 2 3 4 5 6 7 8 | informed_elo(
contestants,
convention,
K = 200,
lambda = 100,
initial.ranks = NULL,
interactions
)
|
contestants |
A dataframe with the identities of the contestants for each study period along with the relevant data for adding them to the hierarchy. There should be one row per contestant per study period. Periods should appear in chronological order. The dataframe should contain the following columns:
|
convention |
A flag determining how new individuals are added to the hierarchy. The value of this flag influences how the convention1 and convention2 columns of the contestants argument are interpreted. Currently this function supports five options:
|
K |
Parameter influencing the magnitude of score changes after each outcome. |
lambda |
Parameter influencing the shape of the logistic function linking the difference in score between winner and loser to the expected probability of each contestant winning. |
initial.ranks |
The initial ordering of individuals for the first study period. Required if using maternal rank inheritance as the convention. For other conventions, if initial.ranks is not specified, the order determined by convention1 is used to create the initial order. |
interactions |
A dataframe of interaction data with the following columns:
|
Produces a dataframe with the following columns:
Study period.
Identity of contestant.
Elo-rating score of contestant.
Ordinal rank of contestant in study period. Lower numbers equal higher rank.
Rank of contestant standardized for group size. Values range from 1 (highest rank) to -1 (lowest rank).
Identity of contestants arranged in the previous order (the order they were in before updating the order based on observations from current study period).
Strauss ED & Holekamp KE (in revision). Journal of Animal Ecology.
Albers PCH & de Vries H (2000). Animal Behavior.
1 2 3 4 5 6 7 8 | ##Informed elo
female.ranks <- informed_elo(contestants = C.crocuta.female$contestants, convention = 'mri',
initial.ranks = C.crocuta.female$initial.ranks,
interactions = C.crocuta.female$interactions)
##Standard elo
female.ranks <- informed_elo(contestants = C.crocuta.female$contestants, convention = 'none',
interactions = C.crocuta.female$interactions)
|
Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.