# STV v1.0.1

0

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.

# 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:

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!