social_choice: Election Social Choice Functions

In elections.dtree: Ranked Voting Election Audits with Dirichlet-Trees

Election Social Choice Functions

Description

Compute election outcomes on ranked ballots with a variety of social choice functions.

Usage

social_choice(
  ballots,
  sc_function = c("plurality", "irv", "stv"),
  n_winners = 1,
  ...
)

Arguments

ballots	A 'prefio::preferences' object containing the ballots cast in the election.
sc_function	One of "plurality", "irv" or "stv", corresponding to the social choice function you wish to evaluate.
n_winners	Refers to the number of seats available when 'sc_function' is "stv".
...	Unused.

Value

The output depends on the chosen 'sc_function':

"plurality"

A character vector with the candidate(s) who received the most votes.

"irv"

A named 'list' with two objects. First, "elimination_order" is a vector with each eliminated candidate in the order of elimination. Second, "winners" is the vector containing the winning candidate(s).

"stv"

Not yet implemented.

elections.dtree documentation built on Sept. 16, 2023, 5:06 p.m.