elections.dtree (version 2.0.0)

sample_posterior: Draw election outcomes from the posterior distribution.

Description

sample_posterior draws sets of ballots from independent realizations of the Dirichlet-tree posterior, then determines the probability for each candidate being elected by aggregating the results of the social choice function. See dtree_evoteid;textualelections.dtree for details.

Usage

sample_posterior(
  dtree,
  n_elections,
  n_ballots,
  n_winners = 1,
  replace = FALSE,
  n_threads = NULL
)

Value

A numeric vector containing the probabilities for each candidate being elected.

Arguments

dtree

A dirichlet_tree object.

n_elections

An integer representing the number of elections to generate. A higher number yields higher precision in the output probabilities.

n_ballots

An integer representing the total number of ballots cast in the election.

n_winners

The number of candidates elected in each election.

replace

A boolean indicating whether or not we should re-use the observed ballots in the monte-carlo integration step to determine the posterior probabilities.

n_threads

The maximum number of threads for the process. The default value of NULL will default to 2 threads. Inf will default to the maximum available, and any value greater than or equal to the maximum available will result in the maximum available.

References

dtree_eiselections.dtree.

dtree_evoteidelections.dtree.