pyrcv

PyPi Status Test Status Documentation Status

Python project for adjudicating ranked choice voting elections using the single transferable vote (STV) method. For more information on ranked choice voting, visit the FairVote website on RCV.

The project also contains a small flask server for adjudicating and visualizing election results from a CSV file. It is automatically deployed at at pyrcv.org

Features

  • General standards and APIs for voting data and vote tabulation.

  • Tabulation of ranked-choice elections using the single-transferable-vote (STV) method.

  • Support for both single-winner and multi-winner contests.

  • Generation of Sankey diagram showing the flow of vote counts through the rounds of a multi-round election.

  • Parser for converting Google Form based election output to voting data standard format.

  • Web server which processes CSV data output from a Google Form based election, and displays winners and a Sankey diagram.

Credits

Inspired by FairVote and CalRCV. FairVote’s examples were extremely helpful for development and correctness-testing.

This package was created with Cookiecutter and the audreyr/cookiecutter-pypackage project template.