STV v1.0.1

0

Monthly downloads

0th

Percentile

Single Transferable Vote Counting

Implementations of the Single Transferable Vote counting system. By default, it uses the Cambridge method for surplus allocation and Droop method for quota calculation. Fractional surplus allocation and the Hare quota are available as options.

Readme

STV

# Implementations of the Single Transferable Vote (STV) counting system. By default, it uses the Cambridge method for surplus allocation and Droop method for quota calculation. Fractional surplus allocation and the Hare quota are available as options.

Current package build status via use of Travis CI:

More Information on STV

See a page from the Electoral Reform Society, or of course Wikipedia. A second Wikipedia page describes the history and use of the STV system. There is also a cute video cartoon on YouTube that you might enjoy.

Getting Started

To load the package in R directly from github, you may use the following commands:


> library(devtools)
> install_github('jayemerson/STV')
> library(STV)

Feedback

Although there are many ways of counting single transferable votes, this package supports only two quota methods and two surplus reallocation methods. We welcome collaboration as we expand the vote count method options.

Jay's Github notes (because I can never remember...)

After creating the public repository on GitHib, essentially empty with only README.md, I cloned to my laptop:

git clone https://github.com/jayemerson/STV.git

I then moved the package contents into the local STV directory, at which point the following workflow appears sufficient for my own purposes:


git status
git commit -am "Short commit message here"
git push origin

If I'm not working with anyone, I'm pretty much set. I do work and then push the changes, end-of-story. But if someone submits a pull request to the master on Github that I accept, I need to update my local copy with this new contribution:


git pull

At this point, I think that's it. I'm not using any special branches or anything (maybe I should, but I'm not).

Functions in STV

Name Description
cleanBallots Tries to Address validateBallots() Warning(s).
STV-package STV Vote Counting
validateBallots Validates Input Data Format for stv().
stv Implement STV Counting Systems
ballots ballots data contains rankings of 44 candidates by 489 people. 10 rows are black, which will prompt an error. This data follows the structure of a 2016 Yale faculty senate election, but vote choices have been permuted and candidate names have been removed.
No Results!

Last month downloads

Details

Type Package
URL https://github.com/jayemerson/STV
BugReports https://github.com/jayemerson/STV/issues
License LGPL-3
Encoding UTF-8
LazyData true
RoxygenNote 6.0.1
NeedsCompilation no
Packaged 2019-03-07 20:54:32 UTC; jay
Repository CRAN
Date/Publication 2019-03-07 21:22:51 UTC

Include our badge in your README

[![Rdoc](http://www.rdocumentation.org/badges/version/STV)](http://www.rdocumentation.org/packages/STV)