bbt 0.1.0

A skill-rating system similar to Elo, Glicko or TrueSkill

Crate bbt [] [src]

BBT is an implementation of a skill-rating system similar to Elo, Glicko or TrueSkill. It follows Algorithm 1 from the paper A Bayesian Approximation Method for Online Ranking.

Usage

As a first step, you need to instantiate a Rater:

let rater = bbt::Rater::new(25.0/6.0);

The new() function takes one parameter, β. This parameter describes how much randomness (variance in outcomes) your game has. For example, a game like Hearthstone is much more luck-based than chess and should have a higher variance; you may need to experiment to see which value has the highest predictive power.

Two-player games (e.g. Chess)

BBT has a convenience function for two-player games that returns the new ratings for the two players after a game. In the example, p1 wins against p2:

let rater = bbt::Rater::default();

let p1 = bbt::Rating::default();
let p2 = bbt::Rating::default();

let (new_p1, new_p2) = rater.duel(p1, p2, bbt::Outcome::Win);

The bbt::Outcome enum can take on the values Win, Loss and Draw.

Multiplayer games

Games with more than two players will have to use the general update_ratings method. It takes a vector of teams and a vector of ranks, with each team being a vector of player ratings. If no error occurs, the method returns a vector of the same form as the input with updated ratings.

Example 1: Racing Game

In a racing game without teams, each player is represented as a "team" of one, and since there are usually no ties in a racing game, the list of ranks contains no duplicates:

let rater = bbt::Rater::default();

let p1 = bbt::Rating::default();
let p2 = bbt::Rating::default();
let p3 = bbt::Rating::default();
let p4 = bbt::Rating::default();
let p5 = bbt::Rating::default();
let p6 = bbt::Rating::default();

let new_ratings = rater.update_ratings(vec![vec![p1], vec![p2], vec![p3],
                                            vec![p4], vec![p5], vec![p6]],
                                       vec![1, 2, 3, 4, 5, 6]).unwrap();

In the example, the first player places first, the second player second, and so on.

Example 2: Tied Teams

Let's say you have a hypothetical game with four teams and two players per team.

Team 1 Team 2 Team 3 Team 4
Alice Charlie Eve Gabe
Bob Dave Fred Henry

If Team 1 wins, and Team 2 and 3 draw for second place and Team 4 loses, you can call the update_ratings function as follows:

let rater = bbt::Rater::default();

let alice   = bbt::Rating::default();
let bob     = bbt::Rating::default();
let charlie = bbt::Rating::default();
let dave    = bbt::Rating::default();
let eve     = bbt::Rating::default();
let fred    = bbt::Rating::default();
let gabe    = bbt::Rating::default();
let henry   = bbt::Rating::default();

let new_ratings = rater.update_ratings(vec![vec![alice, bob],
                                            vec![charlie, dave],
                                            vec![eve, fred],
                                            vec![gabe, henry]],
                                       vec![1, 2, 2, 4]).unwrap();

The second vector assigns a rank to the teams given in the first vector. Team 1 placed first, teams 2 and 3 tie for second place and team 4 comes in fourth.

Rating scale

The default rating scale follows TrueSkill's convention of ranks from 0 to 50. You should be able to use a different scale by specifying the middle of that scale in Rating::new(). For example, to use a more traditional scale of 0 to 3000, you can initialize ratings with Rating::new(1500.0, 1500.0/3.0). You'll also need to adjust the β-value of the Rater instance accordingly: Rater::new(1500.0/6.0).

Structs

Rater

Rater is used to calculate rating updates given the β-parameter.

Rating

Rating represents the skill of a player.

Enums

Outcome

Outcome represents the outcome of a head-to-head duel between two players.