Class RandomCandidates<C>

Pick a candidate at random, regardless of the ballots

Type Parameters

C extends string

Hierarchy

RandomMethod<C>
- RandomCandidates

Index

Constructors

Properties

candidates rng isRandom needsBallot needsMatrix

Methods

canonicalRanking deTie iteratedRanking ranking restrict restrictRanking scores

Constructors

constructor

new RandomCandidates<C extends string>(
i: { candidates: C[]; rng?: () => number },
): RandomCandidates<C>
Type Parameters
- C extends string
Parameters
- i: { candidates: C[]; rng?: () => number }
Returns RandomCandidates<C>
Inherited from RandomMethod<C>.constructor
- Defined in classes/random-method.ts:16

Properties

`Readonly`candidates

candidates: C[]

`Protected` `Readonly`rng

rng: () => number

`Static` `Readonly`isRandom

isRandom: true

`Static` `Readonly`needsBallot

needsBallot: boolean = false

`Static` `Readonly`needsMatrix

needsMatrix: boolean = false

Methods

canonicalRanking

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

deTie

deTie(): C[][]
Returns C[][]
Inherited from RandomMethod.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 RandomMethod.iteratedRanking
- Defined in classes/method.ts:50

ranking

ranking(): C[][]
Returns C[][]
Overrides RandomMethod.ranking
- Defined in methods/random-candidates/index.ts:10

restrict

restrict<D extends string>(candidates: D[]): Method<D>
Return a new instance of the same method restricted to a subset of candidates.
Type Parameters
- D extends string
Parameters
- candidates: D[]
Returns Method<D>
Inherited from RandomMethod.restrict
- Defined in classes/random-method.ts:26

restrictRanking

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

scores

scores(): ScoreObject<C>
Returns ScoreObject<C>
Overrides RandomMethod.scores
- Defined in methods/random-candidates/index.ts:14