votes
    Preparing search index...

    Class Approbation<C>

    Type Parameters

    • C extends string

    Hierarchy

    • BallotScoreMethod<C>
      • Approbation
    Index
    • Type Parameters

      • C extends string

      Parameters

      • c: { ballots: Ballot<C>[]; candidates: C[]; unrankedLast?: boolean }
        • ballots: Ballot<C>[]
        • candidates: C[]
        • OptionalunrankedLast?: boolean

          Whether candidates a ballot leaves unranked are appended to it as one tied bottom tier (default true — the classic "pessimistic" completion of partial ballots). Pass false to score only what voters expressed: unranked candidates then earn nothing from that ballot (no Borda points, no transfers, no last-place counts).

      Returns Approbation<C>

    ballots: Ballot<C>[]
    candidates: C[]
    unrankedLast: boolean
    isRandom: boolean = false
    needsBallot: true
    needsMatrix: boolean = false
    • 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>[]

    • Returns 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[][]

    • Result of the vote. The first item lists the winners of the vote.

      For example this ranking means that Bear wins, Sheep is second and Lion third [ [ 'Bear' ], [ 'Sheep' ], [ 'Lion' ] ]

      Returns C[][]

    • 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 BallotMethod<D>

    • Type Parameters

      • D extends string

      Parameters

      • candidates: D[]

      Returns D[][]