ethanmad / 2018-bptool

Standalone tool for estimating Bayesian posterior loss from election tally for ballot-polling audit.

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

2018-bptool

Standalone tool for estimating Bayesian posterior loss from election tally for ballot-polling audit.

Usage

bptool.py can be run with python3 in two ways: one for single-county ballot-polling audits, and one for multi-county ballot-poling audits.

Single County

If the election only has one county enter tallies as numbers e.g.

python3 bptool.py 20000 40 60 10

where the first number is the total number of votes cast, and the following numbers are the number of votes seen for each candidate in the auditing done so far.

Multiple Counties

If the election spans multiple counties, it might be easier to pass in the sample tallies as a csv file

python3 bptool.py --path_to_csv test.csv

Additional inforomation on usage and optional arguments can be view via:

python3 bptool.py -h

Output

The output for a single-county ballot-polling audit might look like (for the above command python bptool.py 200000 40 60 10):

```Candidate name           	 Estimated probability of winning a full recount
``` 2                        	   97.86 %  
``` 1                        	    2.14 %  
``` 3                        	    0.00 %  

## Importing bptool.py
The module ``bptool.py`` may also be imported into other python code,.  See the
code for guidance.

About

Standalone tool for estimating Bayesian posterior loss from election tally for ballot-polling audit.

License:MIT License


Languages

Language:HTML 77.6%Language:Python 22.4%