pref_voting is a Python packaging that contains tools to reason about election profiles and margin graphs, and implementations of a variety of preferential voting methods.
Project description
pref_voting
Installation
With pip package manager:
pip install pref_voting
Documentation
Online documentation is available at https://pref_voting.readthedocs.io.
Profiles and Voting Methods
A profile (of linear orders over the candidates) is created by initializing a Profile class object. This needs a list of rankings (each ranking is a tuple of numbers), the number of candidates, and a list giving the number of each ranking in the profile:
from pref_voting.profiles import Profile
rankings = [(0, 1, 2, 3), (2, 3, 1, 0), (3, 1, 2, 0), (1, 2, 0, 3), (1, 3, 2, 0)]
rcounts = [5, 3, 2, 4, 3]
prof = Profile(rankings, rcounts=rcounts)
The function generate_profile is used to generate a profile for a given number of candidates and voters:
from pref_voting.generate_profiles import generate_profile
# generate a profile using the Impartial Culture probability model
prof = generate_profile(3, 4) # prof is a Profile object
# generate a profile using the Impartial Anonymous Culture probability model
prof = generate_profile(3, 4, probmod = "IAC") # prof is a Profile object
from pref_voting.profiles import Profile
from pref_voting.voting_methods import *
prof = Profile(rankings, num_cands, rcounts=rcounts)
print(f"{split_cycle.name} winners: {split_cycle(prof)}")
split_cycle.display(prof)
Versions
- v0.1.10 (2022-08-09): Initial release
- v0.1.13 (2022-11-05): Minor updates and bug fixes
Questions?
Feel free to send me an email if you have questions about the project.
License
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for pref_voting-0.1.13-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | dc7939056a07e4ee6feb10879dc0cae9db9e1d608a548cf240edb231cd6fcabe |
|
MD5 | 64c8ec98c67d534e2f1adc038da25f6b |
|
BLAKE2b-256 | a83827a0cec2dd25e9a67f26fa4b65cfe757df82add01f972c1db413b3c1ef0c |