STVPoll 0.5.6

Python versions

Tested on python 3.10 through 3.13.

Example

Case from: https://en.wikipedia.org/wiki/Single_transferable_vote

from stvpoll.scottish_stv import calculate_scottish_stv

candidates = ('orange', 'chocolate', 'pear', 'strawberry', 'bonbon')
# votes can be collections.Counter, dict or list of tuples with candidates and vote count
ballots = {
    ('orange'): 4,
    ('pear', 'orange'): 2,
    ('chocolate', 'strawberry'): 8,
    ('chocolate', 'bonbon'): 4,
    ('strawberry',): 1,
    ('bonbon',): 1,
}

result = calculate_scottish_stv(
    candidates=candidates,
    ballots=ballots,
    winners=3,
)

This will return a ElectionResult object that contains the result and some useful metadata.

Each ballot is a list of candidates in order of preference, so: [‘pear’, ‘orange’] means ‘pear’ before ‘orange’ etc.

Count is the number of ballots with those exact preferences. In the above example, 4 people voted for only ‘orange’, two people voted for ‘pear’ and then ‘orange, and so on.

result.elected_as_tuple()
('chocolate', 'orange', 'strawberry')

Code & Contributions

You may fork the code at: https://github.com/VoteIT/STVPoll

Please report any bugs there, or email info@voteit.se