Struct NormalFormGame 

pub struct NormalFormGame {
    pub payoff_matrix_1: Array2<f64>,
    pub payoff_matrix_2: Array2<f64>,
    pub n_strategies_1: usize,
    pub n_strategies_2: usize,
}

A 2-player normal-form game defined by payoff matrices.

Player 1 has n_strategies_1 strategies and player 2 has n_strategies_2 strategies. payoff_matrix_1[i, j] is player 1’s payoff when player 1 plays strategy i and player 2 plays strategy j. Analogously for payoff_matrix_2.

Fields

payoff_matrix_1: Array2<f64>

Payoff matrix for player 1: shape (n_strategies_1, n_strategies_2)

payoff_matrix_2: Array2<f64>

Payoff matrix for player 2: shape (n_strategies_1, n_strategies_2)

n_strategies_1: usize

Number of pure strategies available to player 1

n_strategies_2: usize

Number of pure strategies available to player 2

Implementations

impl NormalFormGame

pub fn new( payoff_1: Array2<f64>, payoff_2: Array2<f64>, ) -> Result<Self, OptimizeError>

Create a new normal-form game from payoff matrices.

Arguments

• payoff_1 - Payoff matrix for player 1 (shape: n1 × n2)
• payoff_2 - Payoff matrix for player 2 (shape: n1 × n2)

Errors

Returns OptimizeError::ValueError if matrix shapes do not match.

pub fn zero_sum(payoff: Array2<f64>) -> Self

Construct a zero-sum game from a single payoff matrix.

Player 2’s payoff is the negative of player 1’s payoff.

pub fn symmetric(payoff: Array2<f64>) -> Result<Self, OptimizeError>

Construct a symmetric game from a single payoff matrix.

In a symmetric game, both players have the same strategy set and the payoff matrix is square. Player 2’s payoff is the transpose of player 1’s.

Errors

Returns OptimizeError::ValueError if the matrix is not square.

pub fn payoff(&self, s1: usize, s2: usize) -> (f64, f64)

Get the payoff pair for a pure strategy profile.

Returns

(payoff_1, payoff_2) for the given strategy indices.

pub fn expected_payoff( &self, mixed_1: &[f64], mixed_2: &[f64], ) -> Result<(f64, f64), OptimizeError>

Compute expected payoffs for mixed strategies.

Arguments

• mixed_1 - Probability distribution over player 1’s strategies
• mixed_2 - Probability distribution over player 2’s strategies

Errors

Returns OptimizeError::ValueError if the strategy lengths are inconsistent or probabilities do not sum to 1.

Trait Implementations

impl Clone for NormalFormGame

fn clone(&self) -> NormalFormGame

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for NormalFormGame

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.