social_choice {elections.dtree}

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.