RunasSudo/pyRCV2
Archived
1
Fork 0
Code Issues Pull Requests Activity
Python/JavaScript framework for counting various preferential voting elections
This repository has been archived on 2021-05-25. You can view files and clone it, but cannot push or open issues or pull requests.
38 Commits 1 Branch 0 Tags 0 B
Python 76.1%
JavaScript 16.6%
HTML 4.4%
CSS 2.4%
Shell 0.5%
4e06dfe068
Go to file
RunasSudo 4e06dfe068
Minor tweaks 
Show progressive transfers during exclusive Gregory exclusion
Don't perform bulk election in the middle of an exclusion
Limit decimals displayed if using fixed numbers with < 2 dps
2020-12-27 21:50:30 +11:00
docs Implement exclusive Gregory and PRSA 1977 rules 2020-12-27 21:25:40 +11:00
html Minor tweaks 2020-12-27 21:50:30 +11:00
pyRCV2 Minor tweaks 2020-12-27 21:50:30 +11:00
.gitignore Make proper HTML interface with presets 2020-10-18 18:58:24 +11:00
build.sh Begin implementation of tie handling 2020-12-23 22:37:48 +11:00
COPYING Initial commit 2020-10-17 18:45:12 +11:00
README.md Files for deployment 2020-12-24 20:23:55 +11:00
requirements.txt Require Python 3.7.x for Transcrypt 3.7.16 2020-12-23 19:57:21 +11:00

README.md

pyRCV2

pyRCV2 is an application for counting various preferential voting elections.

pyRCV2 may be used in a number of different ways:

  • as an online web application, no installation or special software required, at https://yingtongli.me/rcv/
  • as a standalone Python command line application
  • as a library within another Python application

Features

pyRCV2 accepts data in the BLT file format, and can count votes using:

pyRCV2 is highly customisable, including options for:

  • different quotas and quota rules (e.g. exact Droop, Hare) or progressively reducing quota
  • calculations using fixed-point arithmetic or exact rational numbers
  • different tie breaking rules (backwards, random, manual) with auditable deterministic random number generation
  • extensible API for other counting methods

Online usage

After preparing the BLT file, head to https://yingtongli.me/rcv/. Select the BLT file, and click Count. pyRCV2 will count the election and display the results in a count sheet. See here for more detailed instructions.

By clicking Show advanced options, you can customise the options used for the count. A detailed explanation of the various options can be found here.

Command line usage

pyRCV2 may also be invoked as a command line application. Run python -m pyRCV2 --help to view help.

For example, run python -m pyRCV2 stv path/to/blt_file.blt --ties backwards --ties random --random-seed foobar.