https://kakchouch.github.io/ometeotl/documentation/class-reference/game/utility/Recent content in Game utility.py on Ometeotl, an abstract decision meta-modelHugoen-ushttps://kakchouch.github.io/ometeotl/documentation/class-reference/game/utility/utility-overview/Mon, 01 Jan 0001 00:00:00 +0000https://kakchouch.github.io/ometeotl/documentation/class-reference/game/utility/utility-overview/<p>This module defines concrete utility combinators and strategy ranking helpers.</p> <p>Primary structures:</p> <ul> <li><a href="https://kakchouch.github.io/ometeotl/documentation/class-reference/game/utility/weighted-sum-utility/">WeightedSumUtility</a></li> <li><a href="https://kakchouch.github.io/ometeotl/documentation/class-reference/game/utility/lexicographic-utility/">LexicographicUtility</a></li> <li><a href="https://kakchouch.github.io/ometeotl/documentation/class-reference/game/utility/strategy-ranker/">StrategyRanker</a></li> </ul>https://kakchouch.github.io/ometeotl/documentation/class-reference/game/utility/lexicographic-utility/Mon, 01 Jan 0001 00:00:00 +0000https://kakchouch.github.io/ometeotl/documentation/class-reference/game/utility/lexicographic-utility/<p>Source:</p> <ul> <li><a href="https://github.com/kakchouch/ometeotl/blob/main/src/ometeotl_core/game/utility.py">src/ometeotl_core/game/utility.py</a></li> </ul> <p>Local role: Vector-valued utility combinator with explicit criterion ordering and direction.</p> <p>Big-picture role: Game-layer multi-criteria scoring primitive for lexicographic ranking.</p> <p>Inheritance:</p> <ul> <li><a href="https://kakchouch.github.io/ometeotl/documentation/class-reference/model/utility/utility-function/">UtilityFunction</a></li> </ul> <p>Constructor:</p> <ul> <li><code>LexicographicUtility(framework_id, metric_order, metric_directions=None)</code></li> </ul> <p>Method:</p> <ul> <li><code>evaluate(perception, actor, context) -&gt; UtilityFrame</code></li> </ul> <p>See also:</p> <ul> <li><a href="https://kakchouch.github.io/ometeotl/documentation/class-reference/game/utility/weighted-sum-utility/">WeightedSumUtility</a></li> <li><a href="https://kakchouch.github.io/ometeotl/documentation/class-reference/game/utility/strategy-ranker/">StrategyRanker</a></li> </ul>https://kakchouch.github.io/ometeotl/documentation/class-reference/game/utility/ranked-strategy/Mon, 01 Jan 0001 00:00:00 +0000https://kakchouch.github.io/ometeotl/documentation/class-reference/game/utility/ranked-strategy/<p>Source:</p> <ul> <li><a href="https://github.com/kakchouch/ometeotl/blob/main/src/ometeotl_core/game/utility.py">src/ometeotl_core/game/utility.py</a></li> </ul> <p>Local role: Result container for one evaluated strategy and its aggregate utility.</p> <p>Fields:</p> <ul> <li>strategy: <a href="https://kakchouch.github.io/ometeotl/documentation/class-reference/model/strategies/strategy/">Strategy</a></li> <li>utility_frame: <a href="https://kakchouch.github.io/ometeotl/documentation/class-reference/model/utility/utility-frame/">UtilityFrame</a></li> <li>rank_key: tuple[float, &hellip;]</li> <li>terminal_node_ids: list[str]</li> <li>terminal_probabilities: dict</li> </ul> <p>See also:</p> <ul> <li><a href="https://kakchouch.github.io/ometeotl/documentation/class-reference/game/utility/strategy-ranker/">StrategyRanker</a></li> </ul>https://kakchouch.github.io/ometeotl/documentation/class-reference/game/utility/strategy-ranker/Mon, 01 Jan 0001 00:00:00 +0000https://kakchouch.github.io/ometeotl/documentation/class-reference/game/utility/strategy-ranker/<p>Source:</p> <ul> <li><a href="https://github.com/kakchouch/ometeotl/blob/main/src/ometeotl_core/game/utility.py">src/ometeotl_core/game/utility.py</a></li> </ul> <p>Local role: Ranks strategies by evaluating projected terminal nodes with a utility function.</p> <p>Big-picture role: Game-layer bridge from projected strategy structures to comparable utility outcomes.</p> <p>Inheritance:</p> <ul> <li>standard class</li> </ul> <p>Constructor:</p> <ul> <li><code>StrategyRanker(utility_function)</code></li> </ul> <p>Methods:</p> <ul> <li><code>evaluate_strategy(strategy, actor, context=None) -&gt; RankedStrategy</code></li> <li><code>rank_strategies(strategies, actor, context=None) -&gt; list[RankedStrategy]</code></li> </ul> <p>Important behavior:</p> <ul> <li>validates strategy trees before ranking</li> <li>aggregates branch probabilities per child node</li> <li>supports directed acyclic strategies with duplicate terminal paths by accumulating terminal path probabilities per node id</li> <li>supports scalar and multi-criteria utility outputs</li> </ul> <p>See also:</p>https://kakchouch.github.io/ometeotl/documentation/class-reference/game/utility/weighted-sum-utility/Mon, 01 Jan 0001 00:00:00 +0000https://kakchouch.github.io/ometeotl/documentation/class-reference/game/utility/weighted-sum-utility/<p>Source:</p> <ul> <li><a href="https://github.com/kakchouch/ometeotl/blob/main/src/ometeotl_core/game/utility.py">src/ometeotl_core/game/utility.py</a></li> </ul> <p>Local role: Scalar utility combinator that computes weighted linear sums over metrics.</p> <p>Big-picture role: Default game-layer scalar scoring primitive used by <a href="https://kakchouch.github.io/ometeotl/documentation/class-reference/game/utility/strategy-ranker/">StrategyRanker</a>.</p> <p>Inheritance:</p> <ul> <li><a href="https://kakchouch.github.io/ometeotl/documentation/class-reference/model/utility/utility-function/">UtilityFunction</a></li> </ul> <p>Constructor:</p> <ul> <li><code>WeightedSumUtility(framework_id, metric_weights)</code></li> </ul> <p>Method:</p> <ul> <li><code>evaluate(perception, actor, context) -&gt; UtilityFrame</code></li> </ul> <p>See also:</p> <ul> <li><a href="https://kakchouch.github.io/ometeotl/documentation/class-reference/game/utility/lexicographic-utility/">LexicographicUtility</a></li> <li><a href="https://kakchouch.github.io/ometeotl/documentation/class-reference/game/utility/strategy-ranker/">StrategyRanker</a></li> </ul>