EliminationBelowAverage

class whalrus.EliminationBelowAverage(*args, strict=True, **kwargs)

Elimination of the candidates whose score is lower than the average score

Parameters:

• args – Cf. parent class.
• strict (bool) – If True (resp. False), then eliminate the candidates whose score is strictly lower than (resp. lower or equal to) the average.
• kwargs – Cf. parent class.

Examples

>>> rule = RulePlurality(ballots=['a', 'b', 'c', 'd'], weights=[35, 30, 25, 10])
>>> rule.gross_scores_
{'a': 35, 'b': 30, 'c': 25, 'd': 10}
>>> EliminationBelowAverage(rule=rule).eliminated_
{'d'}
>>> EliminationBelowAverage(rule=rule, strict=False).eliminated_
{'c', 'd'}

If no candidates should be eliminated (which may happen only if strict is True), then all candidates are eliminated.

>>> rule = RulePlurality(ballots=['a', 'b'])
>>> rule.gross_scores_
{'a': 1, 'b': 1}
>>> EliminationBelowAverage(rule=rule).eliminated_
{'a', 'b'}

eliminated_

The eliminated candidates.

This should always be non-empty. It may contain all the candidates (for example, it is always the case when there was only one candidate in the election).

Type:NiceSet

qualified_

The candidates that are qualified (not eliminated).

Type:NiceSet