Election

import svvamp

Create a population of 9 voters with preferences over 5 candidates, using the Spheroid model (which extends Impartial Culture to utilities):

random_profile = svvamp.GeneratorProfileSpheroid(n_v=9, n_c=5)
profile = random_profile()

Preference rankings of the voters:

profile.preferences_rk

array([[0, 1, 4, 2, 3],
       [3, 0, 4, 1, 2],
       [4, 2, 3, 1, 0],
       [2, 3, 0, 4, 1],
       [0, 1, 4, 3, 2],
       [2, 1, 4, 3, 0],
       [4, 2, 0, 3, 1],
       [4, 2, 0, 1, 3],
       [1, 4, 0, 2, 3]])

Define a voting rule:

rule = svvamp.RulePlurality()

Load the profile into the voting rule:

rule(profile)

<svvamp.rules.rule_plurality.RulePlurality at 0x2061f15e9a0>

Ballots:

rule.ballots_

array([0, 3, 4, 2, 0, 2, 4, 4, 1])

Scores:

rule.scores_

array([2, 1, 2, 1, 3])

Order the candidates according to their scores:

rule.candidates_by_scores_best_to_worst_

array([4, 0, 2, 1, 3], dtype=int64)

rule.scores_best_to_worst_

array([3, 2, 2, 1, 1])

The winner, her score and her total utility:

rule.w_

4

rule.score_w_

3

rule.total_utility_w_

0.5038515767548695

Decide whether the winner of the election is a Condorcet winner:

rule.w_is_condorcet_winner_ut_abs_

True