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([[2, 0, 4, 1, 3],
       [4, 1, 0, 2, 3],
       [3, 0, 4, 1, 2],
       [3, 1, 4, 2, 0],
       [0, 2, 4, 3, 1],
       [4, 3, 0, 1, 2],
       [1, 4, 2, 0, 3],
       [2, 0, 3, 1, 4],
       [0, 4, 3, 2, 1]])

Define a voting rule:

rule = svvamp.RulePlurality()

Load the profile into the voting rule:

rule(profile)

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

Ballots:

rule.ballots_

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

Scores:

rule.scores_

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

Order the candidates according to their scores:

rule.candidates_by_scores_best_to_worst_

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

rule.scores_best_to_worst_

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

The winner, her score and her total utility:

rule.w_

0

rule.score_w_

np.int64(2)

rule.total_utility_w_

0.7459377376822462

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

rule.w_is_condorcet_winner_ut_abs_

True