Sample games

[oyamad]

It will be helpful to implement a list of sample games, such as

function prisoners_dilemma(;gain::Real=2, loss::Real=2)
    gain <= 0 && throw(ArgumentError("gain must be positive"))
    loss <= 0 && throw(ArgumentError("loss must be positive"))

    payoff_matrix = [1 -loss;
                     1+gain 0]
    return NormalFormGame(payoff_matrix)
end

(This is just one possible, but seemingly popular, way to normalize the payoffs of Prisoners' Dilemma.)

[sglyon]

Perhaps we could put them in a Games.Examples module users could load if they wanted them?

so this wouldn't work:

using Games
pdg = prisoners_dilemma()

but this would

using Games, Games.Examples
pdg = prisoners_dilemma()

[oyamad]

Fine with me.

[QBatista]

@oyamad Any news on this issue?

[oyamad]

Candidates for the name of the module:

1. Games.Examples
2. Games.Samples
3. Games.Generators

Any thoughts?

[shizejin]

Vote for Games.Generators as it allows users to choose different input, rather than just offers different kinds of games with unchangeable payoff matrices.

[cc7768]

I like both Games.Examples and Games.Generators

I think Games.Examples feels a little more intuitive, but that is likely just personal preference.

[QBatista]

I prefer Games.Generators the most - I think Games.Examples and Game.Samples don't necessarily suggest that users have some discretion in choosing payoffs

[oyamad]

For bimatrix_generators see #53.