Class RandomDictator<C>

Type Parameters

C extends string

Hierarchy

RandomBallotMethod<C>
- RandomDictator

Index

Constructors

Properties

ballots candidates rng unrankedLast isRandom needsBallot needsMatrix

Accessors

Methods

ballotsFor canonicalRanking deTie iteratedRanking ranking restrict restrictRanking

Constructors

constructor

new RandomDictator<C extends string>(
    i: {
        ballots: Ballot<C>[];
        candidates: C[];
        rng?: () => number;
        unrankedLast?: boolean;
    },
): RandomDictator<C>
Type Parameters
- C extends string
Parameters
- i: {
      ballots: Ballot<C>[];
      candidates: C[];
      rng?: () => number;
      unrankedLast?: boolean;
  }
Returns RandomDictator<C>
Inherited from RandomBallotMethod<C>.constructor
- Defined in classes/random-ballot-method.ts:14

Properties

`Protected` `Readonly`ballots

ballots: Ballot<C>[]

`Readonly`candidates

candidates: C[]

`Protected` `Readonly`rng

rng: () => number

`Protected` `Readonly`unrankedLast

unrankedLast: boolean

`Static` `Readonly`isRandom

isRandom: true

`Static` `Readonly`needsBallot

needsBallot: true

`Static` `Readonly`needsMatrix

needsMatrix: boolean = false

Accessors

matrix

get matrix(): Matrix<C>
Return a matrix of duels from all the ballots

Returns Matrix<C>
Inherited from RandomBallotMethod.matrix
- Defined in classes/ballot-method.ts:44

Methods

`Protected`ballotsFor

ballotsFor(candidates: C[]): Ballot<C>[]
The stored ballots re-normalized against a subset of candidates, honoring this method's unrankedLast setting. Round-based methods use this to restrict ballots to the candidates still in the running.
Parameters
- candidates: C[]
Returns Ballot<C>[]
Inherited from RandomBallotMethod.ballotsFor
- Defined in classes/ballot-method.ts:37

canonicalRanking

canonicalRanking(): C[][]
Returns C[][]
Inherited from RandomBallotMethod.canonicalRanking
- Defined in classes/method.ts:27

deTie

deTie(): C[][]
Returns C[][]
Inherited from RandomBallotMethod.deTie
- Defined in classes/method.ts:54

iteratedRanking

iteratedRanking(): C[][]
Ranking built by repeated wins instead of the method's own full ranking: run the method, record the winning tier, then re-run it restricted to the remaining candidates for the next place, and so on.

Differs from ranking() whenever the method's full ranking disagrees with how it ranks subsets — e.g. instant runoff orders losers by elimination time, while iterating re-elects a winner at every place.

Returns C[][]
Inherited from RandomBallotMethod.iteratedRanking
- Defined in classes/method.ts:50

ranking

ranking(): C[][]
Returns C[][]
Overrides RandomBallotMethod.ranking
- Defined in methods/random-dictator/index.ts:33

restrict

restrict<D extends string>(candidates: D[]): RandomBallotMethod<D>
Return a new instance of the same method restricted to a subset of candidates. Ballots are filtered to remove candidates not in the subset; unranked candidates are NOT appended (preserves only opinions voters expressed).
Type Parameters
- D extends string
Parameters
- candidates: D[]
Returns RandomBallotMethod<D>
Inherited from RandomBallotMethod.restrict
- Defined in classes/random-ballot-method.ts:29

restrictRanking

restrictRanking<D extends string>(candidates: D[]): D[][]
Type Parameters
- D extends string
Parameters
- candidates: D[]
Returns D[][]
Inherited from RandomBallotMethod.restrictRanking
- Defined in classes/method.ts:37