calc_reserved_value

negmas.preferences.calc_reserved_value(ufun: UtilityFunction, fraction: float = inf, nmin: int = 0, nmax: int = inf, max_cardinality: int | float = inf, finite: bool = True, tight: bool = True) → float[source]

Calculates a reserved value that keeps the given fraction of outcomes (saturated between nmin and nmax).

Remarks:

If finite, the returned reserved value will be guaranteed to be finite as long as ufun always returns finite values.
max_cardinality is used to sample outcomes for continuous outcome spaces
If tight is given then the reserved values will be as near as possible to the range of the ufun