PayoffVector

Source:

src/ometeotl_core/game/normal_form.py

Local role: One row of the payoff matrix: a joint strategy profile together with the utility frame each player receives under that profile.

Big-picture role: Every joint decision produces distinct consequences for each player. A PayoffVector makes those consequences explicit for one particular combination of choices — it is the answer to the hypothetical “what does each player get if everyone plays exactly this way?”

Inheritance:

standard dataclass

Fields:

profile: StrategyProfile — dict[str, Strategy] mapping actor_id → chosen Strategy
payoffs: dict[str, UtilityFrame] — per-actor utility outcomes for this profile

Methods:

to_dict() -> JsonMap

Example:

# Iterate over all strategy profiles and their outcomes
game = NormalFormGame.from_game_state(game_state, payoff_fn)

for vector in game.payoff_vectors:
    for actor_id, frame in vector.payoffs.items():
        print(actor_id, "->", frame.scalar_value)

# Direct lookup for a specific profile
profile = {pp.actor.id: pp.strategies[0] for pp in game_state.players}
vector = game.payoffs_for_profile(profile)
data = vector.to_dict() if vector else None

Ometeotl