Go to file
RunasSudo e3419b6462
Add comments to supplied BLT files
2021-07-23 16:58:46 +10:00
docs Use Pest-based parser for BLT files 2021-07-23 16:45:54 +10:00
html Make stage number link to comment 2021-07-23 00:04:43 +10:00
src Use Pest-based parser for BLT files 2021-07-23 16:45:54 +10:00
tests Add comments to supplied BLT files 2021-07-23 16:58:46 +10:00
.gitignore Initial quick port of HTML interface 2021-06-02 22:45:55 +10:00
COPYING Initial commit 2021-05-28 20:03:55 +10:00
Cargo.lock Use Pest-based parser for BLT files 2021-07-23 16:45:54 +10:00
Cargo.toml Use Pest-based parser for BLT files 2021-07-23 16:45:54 +10:00
README.md Add documentation on constraints 2021-06-27 23:15:33 +10:00
build_docs.sh Implement constraint matrix logic and test case 2021-06-27 17:49:28 +10:00
build_wasm.sh Allow building debug profile from WASM build script 2021-06-13 16:34:27 +10:00
coverage.sh Fix incorrect calculation of code coverage 2021-06-28 00:27:28 +10:00
rustc_bs.sh Add code coverage calculation 2021-06-12 15:37:41 +10:00

README.md

OpenTally

OpenTally is an application for counting various preferential voting elections, with an academic focus, and emphasis on configurability.

OpenTally may be used in a number of different ways:

  • as an online web application, no installation or special software required
  • as a standalone command line application
  • as a Rust library within another application

Features

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

OpenTally is highly customisable, including options for:

  • different quotas and quota rules (e.g. exact Droop, Hare)
  • calculations using fixed-point arithmetic, guarded fixed-point (quasi-exact) or exact rational numbers
  • different tie breaking rules (backwards, random, manual) with auditable deterministic random number generation
  • multiple constraints (e.g. affirmative action rules)

Online usage

After preparing the BLT file, open the web UI. Select the BLT file, and click Count. OpenTally will count the election and display the results in a count sheet.

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.

Once the count is complete, you can click Print result to generate a printable result report.

Command line usage

OpenTally may also be invoked as a command line application. Run ./opentally --help to view help.

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