pygambit.gambit.Game.make_outcome_null#

Game.make_outcome_null(location) → None#

Reset the outcome at location to the null outcome.

For an extensive game, location is a Selector (an H-built expression, evaluated against this game and treated as a flat set of nodes) or a GroupedSelector (an H-built .by(…) expression, whose groups are pooled together). For a strategic game, location is a pure-strategy contingency — a complete mapping from the game’s players’ labels to strategy labels — or an iterable of such contingencies.

Any outcome all of whose references are among location is removed from the game.

Added in version 17.0.0.

Parameters:

location (Selector, GroupedSelector, contingency, or iterable of contingencies) – The nodes or contingencies to reset to the null outcome. Nonempty; each node or contingency may be referenced only once.

Raises:

  • TypeError – If, for an extensive game, location is not a Selector or GroupedSelector.

  • ValueError – If location is empty or contains a repeat, or if a contingency does not specify exactly one strategy for each player.

  • UndefinedOperationError – If the game is in action-graph representation, where outcomes are not represented explicitly.