pygambit.gambit.MixedStrategyProfile.player_regret

MixedStrategyProfile.player_regret(player: Player | str) → float | Rational

Returns the regret of player for playing their mixed strategy, if all other players play according to the profile.

The regret is defined as the difference between the payoff of the best-response strategy and the payoff of the player’s mixed strategy. By convention, the regret is always non-negative.

New in version 16.2.0.

Parameters:

player (Player or str) – The player to get the regret for. If a string is passed, the player is determined by finding the player with that label, if any.

Raises:

• MismatchError – If player is a Player from a different game.

• KeyError – If player is a string and no player in the game has that label.

See also

strategy_regret, max_regret