zelenin / elo
A PHP implementation of Elo rating system
Installs: 4 830
Dependents: 2
Suggesters: 0
Security: 0
Stars: 25
Watchers: 2
Forks: 6
Open Issues: 0
Requires
- php: >=5.3.0
This package is not auto-updated.
Last update: 2024-11-05 03:03:45 UTC
README
A PHP implementation of Elo rating system
Installation
Composer
The preferred way to install this extension is through Composer.
Either run
php composer.phar require zelenin/elo "dev-master"
or add
"zelenin/elo": "dev-master"
to the require section of your composer.json
Usage
Create two players with current ratings:
use Zelenin\Elo\Player; $player1 = new Player(1200); $player2 = new Player(800);
Create match:
use Zelenin\Elo\Match; $match = new Match($player1, $player2); $match->setScore(1, 0) ->setK(32) ->count();
Get players:
$player1 = $match->getPlayer1(); $player2 = $match->getPlayer2();
Get new ratings:
$newRating1 = $player1->getRating(); $newRating2 = $player2->getRating();
Advanced usage
If you want use this library for not-traditional for Elo sports like football, ice hockey, basketball, you may set additional handlers for setting goal index and home correction.
use Zelenin\Elo\Match; use Zelenin\Elo\Player; $player1 = new Player(1200); $player2 = new Player(800); $goalIndexHandler = function ($score1, $score2) { $diff = abs($score1 - $score2); if ($diff > 0) { return sqrt($diff); } return 1; }; $homeCorrectionHandler = function ($home, $diff) { $coefficient = 100; if ($home == 1) { return $diff - $coefficient; } if ($home == 2) { return $diff + $coefficient; } return $diff; }; $match = new Match($player1, $player2); $match->setScore(1, 0) ->setK(32) ->setGoalIndexHandler($goalIndexHandler) ->setHome(2) ->setHomeCorrectionHandler($homeCorrectionHandler) ->count(); $newRating1 = $player1->getRating(); $newRating2 = $player2->getRating();
Info
See Wiki about Elo rating system
Author
Aleksandr Zelenin, e-mail: aleksandr@zelenin.me