sample_posterior: Draw election outcomes from the posterior distribution.

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

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 \insertCitedtree_evoteid;textualelections.dtree for details.

Usage

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

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.

Value

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

References

\insertRef

dtree_eiselections.dtree.

\insertRef

dtree_evoteidelections.dtree.

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