vote (version 2.2-1)

count.votes: Count Votes

Description

Count votes using one of five methods. View valid and invalid ballots.

Usage

count.votes(votes, method = c("auto", "plurality", "approval", "stv", 
    "score", "condorcet", "tworound.runoff"), fsep = "\t", …)
	
invalid.votes(object)
valid.votes(object)

Arguments

votes

Matrix or data frame containing the votes. Rows correspond to the votes, columns correspond to the candidates. If it is a character string it is interpreted as a file name from which the votes are to be read.

method

Voting method to use. If “auto”, the input data is passed through a checker for each of the methods and the one with the largest number of valid votes is used. In case of the same number of valid votes, it goes by their ordering in the function definition.

fsep

If votes is a file name, this argument gives the column separator in the file.

…

Additional arguments passed to the underlying functions, e.g. mcan, max.score etc.

object

Object returned by one of the functions plurality, approval, stv, score, condorcet, tworound.runoff.

Value

Depending which method is used, count.votes returns an object of class vote.plurality, vote.approval, vote.stv, vote.score, vote.condorcet, or vote.tworound.runoff.

Functions valid.votes and invalid.votes return a subset of the input data with valid records and invalid records, respectively.

See Also

stv, approval, score, condorcet

Examples

# NOT RUN {
# Example using the IMS Council dataset modified for score voting
data(ims_score)
# should recognize that it is a dataset with score voting data
count.votes(ims_score, max.score = 9, larger.wins = FALSE)

# All records with score larger than 8 are excluded 
res <- count.votes(ims_score, method = "score", max.score = 8)
head(invalid.votes(res))

summary(res)
# }