Class MajorityJudgment<C>

Ranks by majority grade, ties broken by Balinski–Laraki's majority value.

Wikipedia: Majority judgment

Type Parameters

C extends string

Hierarchy

Method<C>
- MajorityJudgment

Index

Constructors

constructor

new MajorityJudgment<C extends string>(
    i: {
        ballots: readonly Ballot<C>[];
        candidates: readonly C[];
        clampGrades?: boolean;
        countBlank?: boolean;
        grades?: number;
        unrankedLast?: boolean;
    },
): MajorityJudgment<C>
Type Parameters
- C extends string
Parameters
- i: {
      ballots: readonly Ballot<C>[];
      candidates: readonly C[];
      clampGrades?: boolean;
      countBlank?: boolean;
      grades?: number;
      unrankedLast?: boolean;
  }
  - ballots: readonly Ballot<C>[]
  - candidates: readonly C[]
  - OptionalclampGrades?: boolean
    
    Whether a ballot ranked past the worst grade gives its ranks from the worst grade on that grade (default false: it throws).
  - OptionalcountBlank?: boolean
    
    Whether a ballot that grades no one gives everyone the worst grade too, with unrankedLast (default false).
  - Optionalgrades?: number
    
    Number of grades, best first (default 6). A ballot tier's index is its grade.
  - OptionalunrankedLast?: boolean
    
    Whether a ballot that grades someone gives the candidates it leaves out the worst grade (default true). Pass false to count only given grades.
Returns MajorityJudgment<C>
Overrides Method<C>.constructor
- Defined in methods/majority-judgment/index.ts:96

Properties

`Readonly`candidates

candidates: C[]

`Readonly`grades

grades: number

`Static` `Readonly`isRandom

isRandom: boolean = false

`Static` `Readonly`label

label: "MajorityJudgment" = 'MajorityJudgment'

Accessors

matrix

get matrix(): Matrix<C>
Returns Matrix<C>
- Defined in methods/majority-judgment/index.ts:204

Methods

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 Method.iteratedRanking
- Defined in classes/method.ts:85

judgements

judgements(): Judgements<C>
Returns Judgements<C>
- Defined in methods/majority-judgment/index.ts:153

medians

medians(): ScoreObject<C>
Returns ScoreObject<C>
- Defined in methods/majority-judgment/index.ts:162

ranking

ranking(): 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[][]
Overrides Method.ranking
- Defined in methods/majority-judgment/index.ts:169

restrict

restrict(candidates: readonly C[]): this
The same grades, among candidates only: unlike other ballot methods, it does not count afresh, as a grade does not depend on who else runs. With unrankedLast, those a ballot left out keep its worst grade, even if it graded none of candidates.
Parameters
- candidates: readonly C[]
Returns this
Overrides Method.restrict
- Defined in methods/majority-judgment/index.ts:191

`Static`with

with<T extends MethodCtor<string>>(
    this: T,
    options: PropsOf<T> & {
        label?: string;
        mode?: "restricted" | "full" | "recursive";
    },
): readonly [
    T,
    PropsOf<T> & { label?: string; mode?: "restricted" | "full" | "recursive" },
]
The method as an Election method, with options for its constructor and mode or label.
Type Parameters
- T extends MethodCtor<string>
Parameters
- this: T
- options: PropsOf<T> & { label?: string; mode?: "restricted" | "full" | "recursive" }
  - Optionallabel?: string
    
    Name in traces (TieBreakStep.name, StepResult.name) instead of the method's label.
  - Optionalmode?: "restricted" | "full" | "recursive"
    
    Which candidates the method ranks a tie among: the tied ones ('restricted', default), everyone ('full'), or the tied ones, then those of each tie that leaves, until none splits ('recursive').
Returns readonly [
T,
PropsOf<T> & { label?: string; mode?: "restricted" | "full" | "recursive" },
]
Example
```
new Election({
  candidates,
  ballots,
  methods: [Copeland, Borda.with({ mode: 'full' })],
})
```
Inherited from Method.with
- Defined in classes/method.ts:49

Class MajorityJudgment<C>

Wikipedia: Majority judgment

Type Parameters

Hierarchy

Index

Constructors

Properties

Accessors

Methods

Constructors

constructor

Type Parameters

Parameters

ballots: readonly Ballot<C>[]

candidates: readonly C[]

OptionalclampGrades?: boolean

OptionalcountBlank?: boolean

Optionalgrades?: number

OptionalunrankedLast?: boolean

Returns MajorityJudgment<C>

Properties

Readonlycandidates

Readonlygrades

Static ReadonlyisRandom

Static Readonlylabel

Accessors

matrix

Returns Matrix<C>

Methods

iteratedRanking

Returns C[][]

judgements

Returns Judgements<C>

medians

Returns ScoreObject<C>

ranking

Returns C[][]

restrict

Parameters

Returns this

Staticwith

Type Parameters

Parameters

Optionallabel?: string

Optionalmode?: "restricted" | "full" | "recursive"

Returns readonly [ T, PropsOf<T> & { label?: string; mode?: "restricted" | "full" | "recursive" },]

Example

Settings

On This Page

`Optional`clampGrades?: boolean

`Optional`countBlank?: boolean

`Optional`grades?: number

`Optional`unrankedLast?: boolean

`Readonly`candidates

`Readonly`grades

`Static` `Readonly`isRandom

`Static` `Readonly`label

`Static`with

`Optional`label?: string

`Optional`mode?: "restricted" | "full" | "recursive"

Returns readonly [
T,
PropsOf<T> & { label?: string; mode?: "restricted" | "full" | "recursive" },
]