mirror of
https://github.com/furyfire/trueskill.git
synced 2025-11-04 10:12:28 +01:00
85 lines
3.2 KiB
PHP
85 lines
3.2 KiB
PHP
<?php
|
|
namespace Moserware\Skills;
|
|
|
|
require_once(dirname(__FILE__) . "/GameInfo.php");
|
|
require_once(dirname(__FILE__) . "/PlayersRange.php");
|
|
require_once(dirname(__FILE__) . "/TeamsRange.php");
|
|
|
|
/**
|
|
* Base class for all skill calculator implementations.
|
|
*/
|
|
abstract class SkillCalculator
|
|
{
|
|
private $_supportedOptions;
|
|
private $_playersPerTeamAllowed;
|
|
private $_totalTeamsAllowed;
|
|
|
|
protected function __construct($supportedOptions, TeamsRange $totalTeamsAllowed, PlayersRange $playerPerTeamAllowed)
|
|
{
|
|
$this->_supportedOptions = $supportedOptions;
|
|
$this->_totalTeamsAllowed = $totalTeamsAllowed;
|
|
$this->_playersPerTeamAllowed = $playerPerTeamAllowed;
|
|
}
|
|
|
|
/// <summary>
|
|
/// Calculates new ratings based on the prior ratings and team ranks.
|
|
/// </summary>
|
|
/// <typeparam name="TPlayer">The underlying type of the player.</typeparam>
|
|
/// <param name="gameInfo">Parameters for the game.</param>
|
|
/// <param name="teams">A mapping of team players and their ratings.</param>
|
|
/// <param name="teamRanks">The ranks of the teams where 1 is first place. For a tie, repeat the number (e.g. 1, 2, 2)</param>
|
|
/// <returns>All the players and their new ratings.</returns>
|
|
public abstract function calculateNewRatings(GameInfo &$gameInfo,
|
|
array $teamsOfPlayerToRatings,
|
|
array $teamRanks);
|
|
|
|
/// <summary>
|
|
/// Calculates the match quality as the likelihood of all teams drawing.
|
|
/// </summary>
|
|
/// <typeparam name="TPlayer">The underlying type of the player.</typeparam>
|
|
/// <param name="gameInfo">Parameters for the game.</param>
|
|
/// <param name="teams">A mapping of team players and their ratings.</param>
|
|
/// <returns>The quality of the match between the teams as a percentage (0% = bad, 100% = well matched).</returns>
|
|
public abstract function calculateMatchQuality(GameInfo &$gameInfo,
|
|
array &$teamsOfPlayerToRatings);
|
|
|
|
public function isSupported($option)
|
|
{
|
|
return ($this->_supportedOptions & $option) == $option;
|
|
}
|
|
|
|
protected function validateTeamCountAndPlayersCountPerTeam(array &$teamsOfPlayerToRatings)
|
|
{
|
|
self::validateTeamCountAndPlayersCountPerTeamWithRanges($teamsOfPlayerToRatings, $this->_totalTeamsAllowed, $this->_playersPerTeamAllowed);
|
|
}
|
|
|
|
private static function validateTeamCountAndPlayersCountPerTeamWithRanges(
|
|
array &$teams,
|
|
TeamsRange &$totalTeams,
|
|
PlayersRange &$playersPerTeam)
|
|
{
|
|
$countOfTeams = 0;
|
|
|
|
foreach ($teams as $currentTeam)
|
|
{
|
|
if (!$playersPerTeam->isInRange($currentTeam->count()))
|
|
{
|
|
throw new \Exception("Player count is not in range");
|
|
}
|
|
$countOfTeams++;
|
|
}
|
|
|
|
if (!$totalTeams->isInRange($countOfTeams))
|
|
{
|
|
throw new Exception("Team range is not in range");
|
|
}
|
|
}
|
|
}
|
|
|
|
class SkillCalculatorSupportedOptions
|
|
{
|
|
const NONE = 0x00;
|
|
const PARTIAL_PLAY = 0x01;
|
|
const PARTIAL_UPDATE = 0x02;
|
|
}
|
|
?>
|